/* ***********************
 * Version: MPL 1.1
 *
 * The contents of this file are subject to the Mozilla Public License Version
 * 1.1 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * The Original Code is handleResponse.js module.
 *
 * The Initial Developer of the Original Code is Rob Gerns.
 *
 * Portions created by the Initial Developer are Copyright (C) 2011
 * the Initial Developer. All Rights Reserved.
 *
 **************************/
function handleResponse(objHttpRequest) {
    /*************************************************
    * Function Name(s): handleResponse
    *
    * Purpose:
    * Verify the Oister feed is valid, if so, call the 
    * two main functions that will in turn call the various 
    * functions that will actually write all of the data from 
    * the remote XML file into the appropriate places in the 
    * HTML that gets displayed to the user.
    **************************************************/
    var objXmlDocument = objHttpRequest.responseXML;
    var objOisterTag = objXmlDocument.getElementsByTagName("oister");
    var intOisterTagCount = objOisterTag.length;
    var objContainer = document.getElementById("container");

    //Check to see if the XML is a properly formatted Oister feed.
    if (objXmlDocument !== undefined && intOisterTagCount !== undefined &&
            intOisterTagCount > 0) {
        //Call briefSetup function to handle the "brief" section of the feed.
        briefSetup(objXmlDocument);
        //Call shellSetup function to handle the "shell" section of the feed.
        shellSetup(objXmlDocument);
        //Call setTargetAttributes so HTML links will open in default browser.
        setTargetAttributes();
    } 
    //The file isn't an Oister feed, or isn't properly formatted.
    else {
      objContainer.innerHTML = "<h1>Sorry, this isn't a valid Oister feed.</h1>";
    } 
}